3D Graphics Programming with QuickDraw 3D 1.5.4

Highlight State

Labels

ASCII: HighlightState
Binary: hlst (= 0x686C7374 )

Data Format



 
Boolean             highlighted

highlighted: A value of True indicates that affected geometric objects are to receive the highlighting effects specified by an associated highlight style object during rendering. A value of False indicates that the affected objects are not to receive those effects.

Data Size

Description

A highlight state object is used to specify whether affected geometric objects are to receive highlighting effects during rendering. The relevant highlighting effects are specified by an associated highlight style object. If a geometric object's highlight state is set to True (and an associated highlight style object has been defined), then any renderer that supports highlighting will apply the attributes specified by the highlight style object to that geometric object when rendering; these attributes will override incompatible attributes assigned to that geometric object by other means. A highlight state object is idle if no associated highlight style object exists. See "Highlight Styles" , for complete details on highlight style objects.

Parent Hierarchy

Element, attribute.

Parent Objects

Attribute sets. A highlight state object always has a parent object.

Child Objects

None.

Example



 
Container (

    Container (

        HighlightStyle ( )                      # highlight style object

        Container (

            AttributeSet ( )

            DiffuseColor ( 1 0 0 )              # highlighting: red color

        )

    )

    Container (

        Polygon ( ... )

        Container (

            AttributeSet ( )

            DiffuseColor ( 0 0 1 )       # polygon's normal color: blue

            HighlightState ( True )      # polygon is to be highlighted

        )                                # and will appear red when

    )                                    # rendered